home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / BUSINESS / MAKEDEMO.LZH / MDEM4B.EXE / MANUAL.TXT < prev    next >
Text File  |  1992-10-28  |  71KB  |  1,624 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                          M A K E D E M O
  18.                         -----------------
  19.  
  20.  
  21.                             Version 4
  22.                            -----------
  23.  
  24.  
  25.                    U S E R ' S     M A N U A L
  26.                    ---------------------------
  27.  
  28.  
  29.  
  30.                    Last updated:  October, 1992
  31.  
  32.  _______________________________________________________________
  33. |                                                               |
  34. | MakeDemo is NOT a public domain program.  It is Copyright (c) |
  35. | 1989 - 1992 by WindhamWoods Publishing.  All rights reserved. |
  36. |_______________________________________________________________|
  37.  
  38.  
  39. COPYRIGHT INFORMATION
  40.  
  41.         This software and accompanying documentation are
  42. protected by United States Copyright law and also by
  43. International Treaty provisions.  Any use of this software in
  44. violation of Copyright law or the terms of LICENCE.DOC will be
  45. prosecuted to the best of our ability.  The conditions under
  46. which you may copy this software and documentation is clearly
  47. outlined in LICENCE.DOC.
  48.  
  49.         Registered users may install MakeDemo on a computer
  50. attached to a network, or remove it from one computer and install
  51. it on another, provided that the copy will not be used by more
  52. users than the number for which it was licensed.
  53.  
  54.         As a registered user, you may distribute any file which
  55. you create in part or in whole with this software. Further, you
  56. may include any screen(s) that you received with the MakeDemo
  57. distribution as part of your own presentation(s).
  58.  
  59.         Licensee shall not use, copy, rent, lease, sell, modify,
  60. decompile, disassemble, otherwise reverse engineer, or transfer
  61. the licensed program except as provided in this agreement.  Any
  62. such unauthorized use shall result in immediate and automatic
  63. termination of this license.
  64.  
  65.         Where differences exist between the foregoing information
  66. and that contained in "LICENCE.DOC," the latter shall govern.
  67.  
  68.  
  69. ASP Information
  70.  
  71.  
  72.                        _______
  73.                   ____|__     |                (R)
  74.                --|       |    |-------------------
  75.                  |   ____|__  |  Association of
  76.                  |  |       |_|  Shareware
  77.                  |__|   o   |    Professionals
  78.                -----|   |   |---------------------
  79.                     |___|___|    MEMBER
  80.  
  81.  
  82. "This program is produced by a member of the Association of
  83. Shareware Professionals (ASP).  ASP wants to make sure that the
  84. shareware principle works for you. If you are unable to resolve a
  85. shareware-related problem with an ASP member by contacting the
  86. member directly, ASP may be able to help. The ASP Ombudsman can
  87. help you resolve a dispute or problem with an ASP member, but
  88. does not provide technical support for members' products.  Please
  89. write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  90. or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  91. 70007,3536."
  92.  
  93.  
  94.  
  95.                         Table of Contents
  96.  
  97.  
  98. a.      Copyright Information
  99.  
  100.  
  101. I.      Introduction
  102.  
  103.  
  104. II.     The Files of MakeDemo
  105.  
  106.  
  107. III.    Installation
  108.  
  109.  
  110. IV.     Starting Up MakeDemo
  111.  
  112.  
  113. V.      What MSHOW looks for in your Creation
  114.             Menus
  115.             Predefined System Menu Selections
  116.             Code Those Screens
  117.             Menu Mechanics
  118.             Types of Screens
  119.             Prompt Screen
  120.             Be Mouse Ready
  121.  
  122.  
  123. VI.     Creating a Presentation with MDEMO
  124.             MDEMO Features
  125.             Using a Mouse
  126.             Large Fonts
  127.             Overlays, the Key to Presentation Effects
  128.             Screen Test
  129.             Viewing a Work-In-Process
  130.  
  131.  
  132. VII.    Making Single .EXE File Presentations
  133.             Branding (Optional)
  134.  
  135.  
  136. VIII.   MLITE, The MakeDemo Stripped Down Runtime
  137.  
  138.  
  139. IX.     MDEMO Quick Reference
  140.  
  141.  
  142. X.      Customer Support
  143.  
  144. _______________
  145. I. Introduction
  146.  
  147.         MDEMO, for creating, and its companion MSHOW, for
  148. viewing a presentation, together comprise the MakeDemo system
  149. that gives you the ability to present information on a PC or
  150. compatible computer of almost any persuasion, color or
  151. monochrome. And then there is MLITE, a stripped down version of
  152. MSHOW with some limitations on features but worth the trade-off
  153. where disk space is a premium. See section VIII for the
  154. differences.
  155.  
  156. MakeDemo's architecture promotes
  157.  
  158. o   presenting information in as many as 2000 screens that
  159.     include your own menus and sub-menus, as you define them and
  160.     may also include DOS level commands and executibles and/or
  161.     shellintg out to DOS.
  162.  
  163. o   small files: a typical 100 screen self-contained presentation
  164.     consumes 120 kBytes: great for downloading over BBSs.
  165.  
  166. o   small memory usage: less than 80 kBytes of RAM, less memory
  167.     intensive than many TSR applications.
  168.  
  169. o   your own user interface design: you design all screens
  170.     including prompt screens, context sensitive help, etc.
  171.  
  172. o   language independence: your client sees only what you create.
  173.     There are no hard coded screens or messages that pop up in
  174.     your presentations.
  175.     
  176.         First, there's MSHOW.EXE. By itself it does nothing:
  177. rather it reads an external or appended 'resource file'.  Think
  178. of MSHOW as a library of functions that can interpret your
  179. 'presentation' that you create with MDEMO.
  180.  
  181.         Second, there's MDEMO.EXE, used to create presentations
  182. to be displayed by MSHOW.EXE, either separately or combined with
  183. a presentation to form a single EXE file.
  184.  
  185.         MakeDemo gives the novice through expert user the ability
  186. to create slide show type presentations with sound effects,
  187. various screen overlaying techniques, and various delays with
  188. interactive menuing and mouse support.  MakeDemo includes tools
  189. to put full presentation into a single .EXE file complete with
  190. "F1 - Help" and your own order form: no extra file listing each
  191. screen for a presentation or a script language to learn if you
  192. want to include menus.
  193.  
  194.         MakeDemo is to screens what a good word processor is to
  195. paragraphs.  Think of MakeDemo as a text organizer for files of
  196. screens, not paragraphs.  As you work on a creation, add screens,
  197. insert blank screens, import text in 25 line chunks from ASCII
  198. files, screens captured from other software, or other MakeDemo
  199. files, in part or in whole. Then edit one screen at a time, move
  200. segments around or copy segments to "place" on other screens.
  201. Make copies of screens. Delete screens. Save groups of screens to
  202. new files. Sounds like a word processor: except that you scroll
  203. through a file screen by screen rather than line by line.  All
  204. with mouse support. But MakeDemo is more. Give your users control
  205. in how to view presentations. Simulate menu driven software for
  206. very realistic demos. Create a hypertext sort of system for
  207. quickly moving through a large presentation, such as a catalog or
  208. book on disk. Use MakeDemo to create your own menuing system for
  209. DOS which additionally includes detail screens about a DOS
  210. program that is available for calling.  Or use the extra screens
  211. to provide a little training about the program in question.
  212.  
  213.         Manually override color/monochrome display
  214. formatting. Now, when a "color display" is not strictly a color
  215. display, switch over instantly without first exiting to DOS,
  216. typing in some modifying commands, and then restarting the
  217. presentation all over again. In fact, view a presentation in
  218. process being created in color, as it would appear on a
  219. monochrome display.
  220.  
  221.         Choose from many large fonts when creating outstanding
  222. screens. Create boxes with automatic correction for crossing
  223. lines. Customize your own or add to selection of boxes and fonts
  224. with almost any ASCII text editor.
  225.  
  226.  
  227. PLEASE NOTE -
  228.  
  229.     Only one version of MakeDemo exists for both shareware and
  230.     registered use. Without the correct validation code, MDEMO
  231.     comes up in the 'shareware' mode. You need to register your
  232.     use of MakeDemo in order to receive your assigned validation
  233.     code in order to bypass the 'shareware' mode.
  234.  
  235.     Both MDEMO and MSHOW have identical and integral WindhamWoods
  236.     Publishing 'shareware' screens that appear when certain conditions
  237.     are detected. Similarly, MLITE produces a single line
  238.     "reminder."
  239.  
  240.                         Shareware Users:
  241.  
  242.     The 'shareware' screens appear if -
  243.  
  244.     1. You run MDEMO from the command line and do not include the
  245.        correct validation code.
  246.  
  247.     2. You start MSHOW or MLITE to view a presentation either
  248.  
  249.         with no file specified at all, or
  250.  
  251.         with a presentation file specified on the command line
  252.         (or integrated into a single .EXE file) created, or last
  253.         edited, with an unregistered version of MDEMO.
  254.  
  255.     In all cases, whenever the 'shareware' screen appears, pressing any
  256.     key erases that screen and lets you continue, unheeded.
  257.  
  258.  
  259.                         Registered Users:
  260.  
  261.     The serial number for your copy of MakeDemo is located on the
  262.     2nd line of the file MDEMO.WWP. Upon start-up, MDEMO reads
  263.     that number and imbeds it and the validation code that was
  264.     included on the command line with MDEMO into any presentation
  265.     file that is edited or created. As a registered user, make
  266.     sure that the serial number is yours. The validation code
  267.     will only work with it to circumvent any WindhamWoods 'shareware'
  268.     screens from appearing.
  269.  
  270. _________________________
  271. II. The Files of MakeDemo
  272.  
  273.         MakeDemo is supplied in three self-extracting files
  274. listed below. Not only does packing MakeDemo into three files
  275. take about half the disk space, installing MakeDemo on your
  276. system is also easier. Packed into each is the same PACKING.LST
  277. file that completely lists all of the individual MakeDemo files.
  278.  
  279.         The following is a brief description of the three files.
  280. While each can stand alone in its own right, all three contain
  281. files necessary to successfully produce a MakeDemo presentation.
  282. For detailed information on installing MakeDemo on your system,
  283. please read section III - Installation.
  284.  
  285.  
  286. MDEM4A.ZIP              Overview of MakeDemo
  287.       .EXE
  288.              Contains the necessary files to produce a single
  289.              .EXE executable file, DEMO.EXE from WATCH_ME.1ST
  290.              created with MakeDemo. The resulting file with about
  291.              55 screens is a fully functioning sales pitch for
  292.              MakeDemo.
  293.  
  294. MDEM3B.ZIP              A More Elaborate Presentation
  295.       .EXE
  296.              This time you can create a single file presentation
  297.              of MakeDemo's "help" facility. With about 200
  298.              screens, this presentation also created with
  299.              MakeDemo is a more elaborate example of MakeDemo's
  300.              capabilities. And this archive also contains the
  301.              MakeDemo manual.
  302.  
  303. MDEM4B.ZIP              MakeDemo Files
  304.       .EXE
  305.              Contains MDEMO.EXE and the ancillary utilities such
  306.              as the screen capture utility for those who are
  307.              ready to start creating their own presentations.
  308.              Also included are the various .DOC files that
  309.              complete the MakeDemo package. And for those who
  310.              would like a bare-bones MakeDemo runtime, there's
  311.              MLITE.EXE, great for a "shareware" front end to your
  312.              own programs.
  313.  
  314.  
  315. _________________
  316. III. Installation
  317.  
  318.         MakeDemo was designed to be accessed from its own
  319. directory. Therefore, you should place all the files supplied
  320. with MakeDemo in its own directory and include that directory in
  321. the PATH statement of your AUTOEXEC.BAT file.
  322.  
  323. IMPORTANT NOTE:
  324.  
  325.     Be sure to reboot your computer after modifying your
  326.     AUTOEXEC.BAT file. If you need help in this area, consult
  327.     someone knowledgeable in the workings of DOS.
  328.  
  329.         MakeDemo as supplied in three self-extracting files is
  330. ready for "unpacking" and placing on your hard disk (preferable)
  331. or other floppy disk. The full complement of files takes about
  332. 500 kBytes of disk space plus 250 k Bytes for the example files
  333. you'll be creating as you get started.
  334.  
  335.         As part of the unpacking process, you can declare a
  336. destination directory that doesn't as yet exist, in which case
  337. it will first be created automatically and the files unpacked to
  338. it.  Where the directory already exists and the files of an older
  339. version of MakeDemo reside in it, you will be prompted before
  340. overwriting an existing file of the same name, to which you
  341. should answer "yes."
  342.  
  343.         HARD DISK INSTALLATION
  344.  
  345.         Simply place the disk in the A drive and type
  346.  
  347.                 MDEM4A C:\MDEMO         and press <Enter>.
  348.  
  349.                         in like manner type
  350.  
  351.                 MDEM4B C:\MDEMO         and <Enter>.
  352.  
  353.                         in like manner type
  354.  
  355.                 MDEM4C C:\MDEMO         and <Enter>.
  356.  
  357.  
  358.         Once you have included the MakeDemo files in its own
  359. directory and have included that directory in the "PATH,"
  360. you can then call up MakeDemo from within any other directory.
  361. There's no need to keep multiple copies of a file and then
  362. inadvertently loose track of the current one.
  363.  
  364.  
  365.         FLOPPY DISK INSTALLATION
  366.  
  367.         Use of MakeDemo on a computer without a hard disk is not
  368. recommended. The following information is provided for those
  369. hearty souls who persist in overcoming self imposed limitations.
  370.  
  371.         You need to format four disks before continuing. Simply
  372.         place the master disk in the A drive, one of the
  373.         formatted disks in drive B, and type
  374.  
  375.  
  376.                 MDEM4A B:               and press <Enter>.
  377.                 When completed, label disk "MSHOW."
  378.  
  379.         in like manner type, place another formatted disk in
  380. drive
  381.         B and type
  382.  
  383.                 MDEM4B B:               and <Enter>.
  384.                 When completed, label disk "HELP."
  385.  
  386.         in like manner type, place another formatted disk in
  387. drive
  388.         B and type
  389.  
  390.                 MDEM4B C:               and <Enter>.
  391.                 When completed, label disk "DOCS."
  392.  
  393.         The fourth disk holds the files for creating and viewing
  394.         a presentation.
  395.  
  396.         Place the fourth disk in drive A and the "DOCS" disk
  397.         in drive B and type
  398.  
  399.                 COPY B:MDEMO.EXE A:
  400.                 COPY B:*.WWP A:
  401.  
  402.         Replace the disk in drive B with the "HELP" disk and
  403.         type
  404.  
  405.                 COPY B:MDEMO.HLP A:
  406.  
  407.         Replace the disk in drive B with the "MSHOW" disk and
  408.         type
  409.  
  410.                 COPY B:MSHOW.EXE A:
  411.  
  412.         When completed, label disk "MDEMO."
  413.  
  414.  
  415. ________________________
  416. IV. Starting up MakeDemo
  417.  
  418.         Let's start by making an executable of the MakeDemo
  419. "help" system, just as you might do yourself.  All the DOS
  420. machine instructions are contained in the DEMO.BAT file, all
  421. ready to run.  The MDEMO.HLP file and MSHOW.EXE are combined to
  422. form M_HELP.EXE.  The first time you run this program, you'll
  423. see the 1st screen of the "Help" file, a menu screen, AND you
  424. will see disk activity while your computer crunches away creating
  425. an index of all the screens in the "Help" file. The time it takes
  426. to complete this chore depends upon the type machine you are
  427. using. You can use the presentation while the indexing continues
  428. in the background, but response will be sluggish. It's best to
  429. wait until the process is completed before trying to maneuver
  430. through the file.  Once the index is created, subsequent viewing
  431. will start almost immediately: the index, stored to disk is not
  432. recreated, but is automatically read from disk into memory, a
  433. much faster operation.
  434.  
  435.         As a registered user, you received a validation code. If
  436. you wish to use MakeDemo and bypass the "Shareware" screens, you
  437. must include your validation code on the command line when
  438. calling up MakeDemo.
  439.  
  440. NOTE: If you have installed MakeDemo on your hard disk in its
  441. own directory, and have included its directory in the "PATH"
  442. statement of your AUTOEXEC.BAT file and then rebooted, you're
  443. all set to change directory to any other and call up MakeDemo.
  444.  
  445. If, on the other hand, you are using a dual floppy system, place
  446. your MDEMO disk, the fourth one you created in the unpacking
  447. process, in drive A and a preformatted disk in drive B. At the
  448. DOS prompt type PATH=A:\.  Then log onto drive B and you're
  449. ready to call up MakeDemo.
  450.  
  451. For example, if your validation code is SK1234, you would type
  452.  
  453.                 MDEMO SK1234    and <Enter>.
  454.  
  455.         Remember, that code is uniquely yours. Giving it to
  456. someone else along with the program really isn't much of a gift.
  457. After all, the "shareware" screens aren't really that obnoxious.
  458. But violating the copyright laws deprives the authors of MakeDemo
  459. from receiving fair value for value rendered.
  460.  
  461.         If you have any questions once you have called up
  462. MakeDemo you can press F1 to see the "Help" categories from which
  463. to select more detailed help.  There's a lot of information in
  464. this help file. It is in itself a MakeDemo creation, similar to
  465. something which you yourself might wish to create.  To quickly
  466. get up to speed as to what makes a great presentation, use MDEMO
  467. itself to "Edit" the help file. There's no need to make any
  468. changes to the file. Just go through the screens and see how the
  469. menus are defined and what "appearance" options have been
  470. selected. Dissect it, take it apart. That's right -- go into
  471. MakeDemo and edit them and see some of the behind-the-scenes
  472. stuff. MDEMO is just the editor, if you will; MSHOW, the
  473. presenter. We can talk a lot about interactive menus, but a
  474. picture is worth a thousand words, so to speak.
  475.  
  476.         To "Edit" the help file, select for the working
  477. directory that which contains the MakeDemo files, normally the
  478. MDEMO directory. At the DOS prompt type MDEMO and the validation
  479. code, if you are a registered user, and press <Enter>.  When the
  480. menu appears across the bottom of the screen, select "Files,"
  481. highlight the help file, "MDEMO.HLP," and press <Enter>. Up will
  482. pop the first screen of the file. Now to see more of the
  483. screens, use the down and up arrows to move through the file,
  484. observing how the menus are constructed. For now, just observe.
  485. The details follow a little later in this document.  Select
  486. "More" to get the other half of the main menu and select
  487. "Appearance" to see what methods were selected for the screen
  488. that is shown.  Press <Esc> to move through the three appearance
  489. menus so as not to disturb the choices already selected. When
  490. you're finished, press <Escape> and follow the directions.
  491.  
  492. _________________________________________________________________
  493. V.  What Gives MSHOW a Clue as to What, Where, and How to Present
  494.  
  495.         You need not be a 'programmer' in the old sense of the
  496. word in order to create a masterpiece. Knowing one's way around a
  497. word processor is qualification enough. To create an MSHOW
  498. 'presentation' requires following a few simple rules, which we
  499. will get to shortly.
  500.                                            
  501.         MSHOW interprets your presentation or resource file.
  502. There are just a few rules that impact how you go about its
  503. design. Your presentation or resource file is nothing more than a
  504. series of screens that describe to MSHOW your application. All
  505. the unique information is placed on the screens themselves. Upon
  506. presentation, this 'coding' information is blanked out.
  507.  
  508.         Upon startup, MSHOW almost immediately puts up the first
  509. screen, but then continues to 'index' the remaining screens in
  510. the background until completed. Indexing performs a number of
  511. functions. MSHOW creates a list, by name, of all screens in
  512. memory. MSHOW lets you include 'menus' in your document that uses
  513. this index of screen names. A menu is a list of choices, or
  514. screens, from which your user can select to view next. Hence,
  515. only screens that must be referenced need a unique name. MSHOW
  516. saves this index to disk in a file of the same name, but with
  517. the ".INX" extension.  When preparing to display a presentation
  518. MSHOW first looks to see if the index file exists on disk.  If
  519. it is found and its date/time stamp is more recent than that of
  520. the presentation file itself, MSHOW reads it into memory.  Once
  521. created, this feature is a real time saver, especially on slower
  522. systems.
  523.  
  524.         The index file is in reality an ASCII text file. It can
  525. be printed out using the DOS TYPE command.  The name and length
  526. of each screen is stored sequentially, each separated by commas.
  527. You might want to refer to this file created by your own
  528. presentation in order to eliminate conflicts in screen names.
  529.  
  530.         You may also "code" your creation to become a
  531. self-running presentation of sorts. If you wish to let your users
  532. view your document as a presentation (ie. automatically present
  533. screens in menu order at pre-programmed intervals) and
  534. automatically recycle indefinitely, or until <Esc> is pressed,
  535. give your viewer access to the presentation options. (see the
  536. system menu options)
  537.  
  538. Menus:
  539.  
  540.         There is an optional system menu screen and then there
  541. are the menus that are part of information you are presenting.
  542. The system menu, or virtual menu, has the rudimentary selections
  543. such as <F1>, <Esc>, <PgUp>, <PgDn>, and <Tab> always active,
  544. regardless of whether or not you assign additional keys to them
  545. or not. More about that later. These selections are always active
  546. whether or not they can be seen on the screen. This menu, if you
  547. have defined your own, is always as close as the <Tab> key or by
  548. moving the mouse to one of the screen edges.
  549.  
  550.         There are reserved names for these screens which MSHOW
  551. looks for upon startup. MSHOW looks for one and only one screen
  552. with one of these names
  553.  
  554.         LSIDE0        TSIDE0        BSIDE0        RSIDE0
  555.  
  556. PLEASE NOTE: These names are reserved and are not to be used for
  557. any other purpose.  If you do by chance try to include them in
  558. your own menu, strange things will happen and the results will be
  559. something less than acceptable.
  560.  
  561.         The architecture of MSHOW allows, even encourages, you to
  562. design this system menu screen to your own taste. Of course, feel
  563. free to use whatever screens you like of those supplied with
  564. MakeDemo. If you like, modify them with your own context
  565. sensitive "Help".
  566.  
  567. Predefined System Menu Choices:
  568.  
  569.         There are a number of predefined functions which your
  570. system menu may or may not include. That's up to you. For
  571. example, to give your viewer the ability to shell out to DOS, you
  572. must include the appropriate selection on the system menu screen.
  573. Certain names are 'reserved' and if used, MSHOW expects
  574. conformance to the appropriate schema. We'll get into this schema
  575. later, but in the interests of being concise, all the information
  576. you will need for referral purposes is included here in one
  577. place.
  578.  
  579. Those menu selections are
  580.  
  581. Hard-   Soft-
  582. Coded   Coded                Actions Performed
  583. Keys    Functions
  584. -----------------------------------------------------------------
  585.  
  586. <Esc>   QUIT    returns the user to the previous menu, or out to
  587.                 DOS, whichever comes first. In the AUTO
  588.                 presentation mode, discussed below, the first
  589.                 press of <Esc> puts MSHOW into the SOUND mode,
  590.                 discussed below.
  591.  
  592. <PgDn>  PAGEDN  causes the next screen to appear provided screen
  593.                 has no name. A name of "+" or "-" is permitted
  594.                 where a repeating presentation is desired.
  595.  
  596. <PgUp>  PAGEUP  causes the previous screen to appear provided
  597.                 the present screen has no name. A name of "+" or
  598.                 "-" is permitted where a repeating presentation
  599.                 is desired.
  600.  
  601. <Tab>   TAB     causes MSHOW to search all screens stopping
  602.                 at the first with the name "_SIDE0". The "_"
  603.                 represents the characters "R", "T", "B", or "L".
  604.                 When using a mouse, MSHOW can differentiate
  605.                 between the various options, but without the
  606.                 mouse, MSHOW has no clue as to what the first
  607.                 letter might be. Only one system menu screens is
  608.                 permitted.
  609.  
  610. <F1>    HLLP    You can provide a sequence of screens as a
  611.                 general "Help" facility. These might be of a
  612.                 more general nature, explaining the typical
  613.                 maneuvers to progress through a presentation.
  614.  
  615.                 When a system menu screen is being presented,
  616.                 either by pressing the <Tab> key or moving the
  617.                 mouse to an edge, MSHOW presents the first
  618.                 overlay it finds on the screen. (Hopefully it is
  619.                 the system menu.) All other screen segments on
  620.                 that screen only appear when F1 is pressed. (See
  621.                 section on screen overlays.
  622.  
  623.         POFRM   Use this name to define a sequence of screens,
  624.                 such as a Purchase Order Form, that can be
  625.                 accessed from the system menu and or associated
  626.                 "hot" key. Of course, you can name your order
  627.                 form something different and give access to it
  628.                 from your own menu.
  629.  
  630.         PRIN    This key word tells MSHOW to retrace to beginning
  631.                 of a menu selection or order form and send all
  632.                 the pertinent screens to the printer. You have
  633.                 the option of including a "prompt" screen,
  634.                 discussed further on, to give the user the
  635.                 opportunity of aborting the process before
  636.                 actually starting the print operation. If the
  637.                 "prompt" screen does not exist in your file,
  638.                 MSHOW sends the form to the printer, by default.
  639.  
  640.                 A screen is a chunk of 25 lines each. If you want
  641.                 to print a form on a single sheet of paper of 60
  642.                 lines, you are not limited to 2 screens. To
  643.                 prevent particular lines from going to the
  644.                 printer, merely place an <Alt>13 symbol at the
  645.                 beginning of that line on the screen. MSHOW
  646.                 ignores it and skips to the next line.
  647.  
  648.         SHELL   Give your users the ability to interrupt viewing
  649.                 a presentation so as to temporarily go to DOS for
  650.                 doing something else, and then return to the
  651.                 application without losing a step.
  652.  
  653.         COLOR   MSHOW detects whether the system is configured
  654.                 with a monochrome or color monitor. In those
  655.                 cases where the user might not be happy with the
  656.                 default, include this ability to switch.
  657.  
  658.         FFUNC   reserved, but not used.
  659.  
  660.         RSVD    reserved, but not used.
  661.  
  662. R e s e r v e d   f o r   P r o m p t   S c r e e n   O n l y
  663. -------------------------------------------------------------
  664.         YES
  665.  
  666.         NO
  667.  
  668. P r e s e n t a t i o n   O p t i o n s
  669. ---------------------------------------
  670.         N_EFFECT No sound or graphics effects
  671.  
  672.         EFFECT  Graphics Effects such as overlay sliding, etc.
  673.  
  674.         SOUND   Same as above, but includes preset sound effects
  675.  
  676.         AUTO    Self running presentation with programmed delays
  677.  
  678.         As part of your presentation, you have the ability to
  679. include your own menus that allow the user to move through a file
  680. in response to your defined menu selections. One group of screens
  681. might explain certain features of your system, another might be
  682. your order form. You can design menus with up to 30 selections on
  683. a single screen, sub-menus up to fifty deep, with a total of 2000
  684. screens in one file. Think of it as sort of a hypertext
  685. application.
  686.  
  687. Code Those Screens:
  688.  
  689.         There is very little specific coding information that
  690. MSHOW needs to access. MSHOW is designed to do quite a lot on
  691. very little information. MSHOW does need to be able to discover
  692. the names you give to the first screen of a screen sequence.
  693.  
  694.         All these pieces of information are imbedded in lines
  695. starting with either , or  ( ie. <Alt> 4 or <Alt> 6
  696. respectively.) These characters are keyboard accessible by
  697. simultaneously pressing the <Alt> key and the appropriate number
  698. key on the numeric keypad.
  699.  
  700.         Lines prefixed with either of these symbols can up to 80
  701. characters long and must appear within the top 6 lines of a
  702. screen. If one line is insufficient, use additional lines,
  703. provided each starts with the appropriate symbol followed by a
  704. comma. The name following either of the first two symbols can
  705. only appear once, if at all, on a screen.
  706.  
  707.         Generally speaking, the characters following these
  708. symbols mean -
  709.  
  710.  ( <Alt+4> ) screen name and menu selections ( if any. )
  711.  
  712.  ( <Alt+6> ) designates the place on the screen where, just to
  713.   the right, the menu selection.
  714.  
  715.   The area of the screen can have multiple lines but can not
  716.   exceed 256 character spaces. (For example, 8 rows by 32
  717.   columns.) MSHOW uses the color attribute of the area to
  718.   delineates it from that of the surrounding area.
  719.  
  720.   Let's take a closer look at the attribute. This is an important
  721.   point. MSHOW defines the width of a field by looking for a
  722.   background color change as it moves from left to right after
  723.   finding the beginning of the selection or field. The foreground
  724.   color (the printed characters) can differ along the line but
  725.   not the background color. When MSHOW detects a change, it
  726.   calculates the width. MSHOW then travels down the screen in
  727.   this last column looking for any change in foreground and
  728.   background colors. When found, MSHOW calculates the height of
  729.   the menu selection. This is important. You can place menu
  730.   selections on adjacent rows using the same background /
  731.   foreground colors. You ask "How can that be?" By using a
  732.   different foreground color for the last character (usually
  733.   hiden as a space where the different foreground color doesn't
  734.   show.) Because of this trick, you can implement vertical menus
  735.   to your heart's desire.
  736.  
  737.   There is some call for having a vertical menu with the same
  738.   background color as the menu itself. How can I define the end
  739.   of a menu selection if there is to be no apparant change in
  740.   background color? Time to reflect a little. A space or blank
  741.   character presents the background color. A character
  742.   <Alt>+2,1,9 presents a space or blank character in foreground
  743.   color, in effect swapping the background for the foreground
  744.   color. By now you probably see the possibilities. At the right
  745.   edge of the menu where you want the scroll bar to end, place a
  746.   column of character 219 with a same foreground color as the
  747.   surrounding background color. The background color can be
  748.   anything: it won't show anyway. Now the bars work as intended.
  749.   There is one shortcoming though: when viewed in a monochrome
  750.   display, that column of characters 219 might show as a black
  751.   line.
  752.  
  753.   In general, unless I am trying to give a presentation the look
  754.   and feel of some other program, I prefer to delineate menus
  755.   from the rest of the screen with lines and/or color changes.
  756.   But then -- in a MakeDemo presentation, menus need not be whole
  757.   screens unto themselves. Instead, I can draw the viewer's
  758.   attention to the idea of the screen and veil a menu as a window
  759.   to other areas in the presentation for further invesatigation.
  760.  
  761.  
  762. Menu Mechanics:
  763.  
  764.         Here is a typical menu designation. It names the screen
  765. "MENU" and contains six menu selection. Note each line is
  766. prefixed with <Alt+4>. Some printers are unable to print this
  767. character directly.
  768.  
  769.         MENU,ITEM1,ITEM2,ITEM3,ITEM4
  770.         ,ITEM5,ITEM6
  771.  
  772. MENU - is the name of the screen. It is only necessary to give
  773. the screen a name if it is to be called from another menu.
  774.  
  775. ITEM1 - is the first menu selection.
  776.  
  777. ITEM2 - is the second menu selection.     ...and so on.
  778.  
  779.         A screen should never be given a name unless it its to be
  780. assessed from another menu. Here's the rational. MSHOW allows the
  781. user to <PageDown> to adjacent screens if and only if that screen
  782. has no name or if that name is prefixed with a "+" or "-".
  783.  
  784.         If you wish to let your users view your document as a
  785. presentation (ie. automatically present screens in menu order)
  786. and automatically recycle indefinitely, or until <Esc> is
  787. pressed, name the last screen, "-", and the screen to return to
  788. name "+". For example, if you want a repeating presentation to
  789. restart with screen 4, name screen 4 "+". And of course, name the
  790. last screen of the last menu selection "-".
  791.                                       
  792. And now you can include DOS Commands in your Menus:
  793.  
  794.         MakeDemo now gives you the ability to create a DOS menu
  795.     shell of sorts, by defining menu selections to perform
  796.     commands at the DOS level without first exiting your
  797.     presentation. For example, you might wish to include the DOS
  798.     DIR command as a menu selection, or let your user execute
  799.     another program, then return to your presentation. Just
  800.     prefix the name of the DOS command with a '&', as in "&DIR=D"
  801.     if you want to use a "D" for a "hot" key. That's all there is
  802.     to it. Run BAT files or EXE or COM executibles right from
  803.     within your presentation. There's a lot you can design into
  804.     your presentation.
  805.  
  806.         When <PagingUp> MSHOW lets you go no further back than a
  807. screen with a name. It shouldn't be too hard to visualize that a
  808. sequence of screens can be made inaccessible simply by giving the
  809. first of the sequence a name and then NOT including that name in
  810. any of your menus.
  811.  
  812.         The screen name, in this case "MENU", indicates that this
  813. screen, in addition to having a menu of its own, is to be
  814. accessed only from another menu screen.
  815.  
  816.         MSHOW recognizes hot keys and/or function keys that you
  817. so designate as part of your menu.  To use this feature you
  818. include the designator with the menu selection above. For
  819. example, if we change menu item 1 to
  820.  
  821.                 "ITEM1=B-FF6",
  822.  
  823. then pressing the 'B' key or the 'F6' function key will also
  824. cause item 1 to be selected. A more realistic selection might be
  825.  
  826.                 "SHELL=S-FF6".
  827.  
  828. If you layout the menu screen with the "S" for "SHELL" bright
  829. white and the rest of the letters the subdued while or grey,
  830. right away the user intuitively knows that pressing the "S" key
  831. will cause "SHELL" to activate.
  832.  
  833. All the keys of the alphabet are permitted as well as all the
  834. Function Keys, Control / Function keys, Shift / Function Keys,
  835. and Alternate / Function keys. The following is a list of the
  836. possibilities.
  837.  
  838.                 FF1  through FF10
  839.                 CF1  through CF10
  840.                 SF1  through SF10
  841.                 AF1  through AF10
  842.  
  843.         You can designate a hot key with a different foreground
  844. color for that key in your actual menu selection.
  845.  
  846. IMPORTANT NOTE:
  847.  
  848.     The equal "=" sign must precede the "hot" key, the "-" must
  849.     precede the function key designation. Failure to respect this
  850.     constraint will appear as non working or unwanted key
  851.     assignments.
  852.  
  853.         For example, the following example should clarify things.
  854. Here is a menu selection of 4 rows of 20 characters each. The 'x'
  855. designates different foreground / background colors from those of
  856. the surrounding area.
  857.  
  858.         <Alt+6> xxxxxxxxxxxxxxxxxxxx
  859.                  xxxxxxxxxxxxxxxxxxxx
  860.                  xxxxxxxxxxxxxxxxxxxx
  861.                  xxxxxxxxxxxxxxxxxxxx
  862.  
  863.         You can place selections anywhere on the screen, put them
  864. in list boxes or in bars like those of MakeDemo. Or you can imbed
  865. them in text to make certain words "hot."
  866.  
  867.         Think of menus as a tree with branches. Start at the base
  868. of the tree (DOS) and climb up into the tree and trace your steps
  869. as you explore out to a leaf.  You probably won't give your
  870. viewers as many choices as they explore your "tree," but the
  871. concept is similar.  With MakeDemo the branches can vary in
  872. length, which is to say that you can show a number of screens
  873. before coming to the next named screen for another menu selection
  874. defined elsewhere. MSHOW lets your viewer progress through a
  875. series of screens until the next screen has a name defined.
  876. Normally MakeDemo restricts the viewer from traversing backwards
  877. through the presentation only until he or she comes to a screen
  878. with a label on it.  You remember: a "label" is used by the menu
  879. to know which screen to present when a menu selection is made.
  880. Trying to progress further returns the viewer to menu from whence
  881. he or she came. Except...
  882.  
  883.         There might be times when you might allow the viewer to
  884. move into the next menu selected series of screens without first
  885. returning to a menu.  For example, if you are putting together a
  886. catalog with a "Table of Contents," you might just as well let
  887. the viewer roam around in the general area without forcing a
  888. return to the "menu," before moving on.  Those screens must have
  889. names starting with a '+'.
  890.  
  891.  
  892.         For example, suppose screens are arranged as follows:
  893.  
  894. Screen             Label                        Choices
  895. 1
  896. 2     <ALT+4>+MENU,GOTO1,GOTO2          <ALT+6>GOTO1
  897.                                         <ALT+6>GOTO2
  898. 3     <ALT+4>HLLP
  899. 4
  900. 5
  901. 6     <ALT+4>GOTO1
  902. 7
  903. 8
  904. 9     <ALT+4>GOTO2
  905. 10
  906. 11
  907. 12
  908. 13
  909. 14    <ALT+4>-MENU
  910.  
  911.         This would be a organization of a typical presentation
  912. file. Here there would be a menu somewhere on screen 2 with two
  913. choices: "GOTO1" and "GOTO2." Screens 6, 7 and 8 associated with
  914. GOTO1 and screens 9 through 14 are reached by selecting GOTO2.
  915. There is only one way to get to screen 6: that is by selecting
  916. GOTO1 from screen 2. However, there is an additional way to
  917. access screen 9; that is from screen 8, but only f the screen
  918. name were prefixed by a "-" sign.
  919.  
  920.         Now, if all that is true, then how does one access
  921. screens 3 through 5? That's simple; just press F1. Those screens
  922. are the "Help" facility, if you choose to have one. To include
  923. "Help," the first screen must be labeled "<ALT+4>HLLP".
  924.  
  925.         The "Help" screens should always be placed just after a
  926. menu screen or after the last screen of a choice. In that way
  927. there is no way for the user to stumble into Help except by
  928. pressing F1.
  929.  
  930.         Now, you may inquire about the choice on screen 14.
  931. There are several things you can do on the last screen. We chose
  932. to use the name of screen 2, the reason being that trying to
  933. move beyond that screen either in manual or automode will cause
  934. the presentation to repeat the presentation starting with screen
  935. 2. Or I could have given it no name, in which case, the
  936. presentation would wait there indefinitely for someone to press
  937. <Esc>, which would precipitate a return to DOS.
  938.  
  939.         There is one other nuance having to do with menus that
  940. you might have missed in viewing the presentation. For the
  941. sequence of screens shown above, you might have wondered what
  942. would happen when MakeDemo presented a menu while in the "auto"
  943. mode. Well, MSHOW would assume that you want to sequentially
  944. go through the menu and present every branch out to each leaf,
  945. return to the menu and follow the next branch, and so on. There
  946. might be a situation where you would like your viewer to be in
  947. automatic mode, but then stop at a menu screen and wait
  948. indefinitely for a key press. To do that merely precede the name
  949. of the menu screen with a question mark, "?". MakeDemo leaves it
  950. up to you as to how you wish your viewers to use your
  951. presentation.
  952.  
  953. Types of Screens:
  954.  
  955.         As you might have surmised from viewing one of the
  956. presentations supplied with this package, MSHOW interprets each
  957. screen before presenting it.  A screen is presented either in
  958. whole (completely replacing the previous screen) or various
  959. rectangular shaped portions of the next screen "overlay" their
  960. respective segment of what's already on the screen.  For the most
  961. part, you the creator of the presentation determine how a screen
  962. is designed and how it is to be presented. For example, the first
  963. half dozen or so choices from which to choose on the "Appearance"
  964. menu (when working on a screen from within MDEMO) are whole
  965. screen "overlays" if you will.  The rest are called "segments."
  966. Strictly speaking, menu screens are show in segments, regardless
  967. of the "appearance" mode selected.  We will get to that a little
  968. further on.
  969.  
  970.         How does MSHOW know a "segment" from a whole screen, you
  971. ask?  A blank screen (black background with characters, if any,
  972. of a dull foreground color appears transparent when presented by
  973. one of the "segment" modes.  To get the attention of MSHOW for
  974. presentation, that portion of the screen with bright foreground
  975. on a black background or any foreground on any background other
  976. than black will appear. MSHOW finds those segments by searching
  977. each row top to bottom looking for the first color combination
  978. described above. Defining that point as the upper left corner of
  979. the segment, MSHOW then travels that row looking for the first
  980. instance of a change in background color, defining it as the
  981. segment's upper right corner.  MSHOW then moves back to the
  982. upper left corner and scans down this first column looking for a
  983. change in foreground or background color to determine the height
  984. to then calculate the bottom right and bottom left segment
  985. corners.  After presenting a segment, MSHOW then repeats the
  986. process finding and presenting all the other screen segments,
  987. left to right, top to bottom in that order.
  988.  
  989. IMPORTANT NOTE:
  990.  
  991.     The procedure MSHOW follows to define segment corners differs
  992.     from that of defining the corners of menu selections. For
  993.     segments the top and left edges solely define the designated
  994.     area; for menu selections, the top and right edges solely
  995.     define their respectful areas. Don't confuse the two.  Here's
  996.     the rational. Segments such as "windows" type boxes with
  997.     highlighted edges to simulate sloping edges frequently use
  998.     the same colors for the top and left edges. Menus, on the
  999.     other hand, need the blank space at the end rather than at
  1000.     the beginning of a line to hide the key to its width.
  1001.  
  1002.         How does MSHOW present a "whole" screen (i.e. one that
  1003. was intended for showing in segments) that is given one of the
  1004. "segment" appearance modes?  That depends. If the edges of the
  1005. screen have the same background and foreground color, no problem.
  1006. A quick way to determine that (when in MDEMO) is to select "Pick
  1007. & Place" and then "Screen Test." Diamond symbols appear at each
  1008. character location, making a visual check very easy. What happens
  1009. if the edges are not of the same foreground/background colors?
  1010. MSHOW starts with the upper left edge of the screen and scans to
  1011. the right looking for a change in background color, and so on.
  1012. The results are usually not what you intended. "Screen test" all
  1013. screens and correct any problems before viewing a series of
  1014. screens with MSHOW.  After you have worked on a screen for a
  1015. while, the amount of various foreground colors on a blank
  1016. sections of screen will surprise you. And what's more, that
  1017. carelessness will increase the size of your presentation file,
  1018. conceivably by up to 20 percent.
  1019.  
  1020.         As I mentioned before, "menu" screens come up after MSHOW
  1021. finds what it perceives as the first segment. MSHOW does not look
  1022. further for more on menu screens. On the system menu screen more
  1023. segments are allowed that can be accessed by the viewer pressing
  1024. function key F1 for help.  That's the only exception. So you want
  1025. to be particularly careful with menu screens; lest some blank
  1026. segment gets presented: and nothing seems to appear.
  1027.  
  1028.         The foregoing discussion also applies the "Prompt"
  1029. screens discussed next.
  1030.  
  1031.  
  1032. "PROMPT" Screen
  1033.  
  1034.         There is one situation whereby you might wish to prompt
  1035. your user with a question and wait for an answer before
  1036. proceeding. For example, before sending something to a printer,
  1037. you might give your user instructions and a chance to abort the
  1038. process before continuing. The screen name "PROMPT" is reserved
  1039. for such an event. The screen is defined with
  1040.  
  1041.       <Alt+4>  PROMPT,,,,
  1042.  
  1043.  
  1044. and the screen is layed out with 5 selections, the first three
  1045. designated for information display, the last two for possible
  1046. answers.  For example
  1047.  
  1048.  
  1049.       <Alt+6>   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  1050.  
  1051.       <Alt+6>   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  1052.  
  1053.       <Alt+6>   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  1054.  
  1055.              <Alt+6>  Yes    <Alt+6> No
  1056.  
  1057.         The same rules apply here as for menu selection.
  1058.  
  1059.         And then somewhere on this screen is the information to
  1060. be used when a prompt message is to be displayed.
  1061.  
  1062. For example,
  1063.  
  1064. 9,Order Form is Next,Prepare Printer,Continue ?,YES=Y,NO=N,1
  1065.  
  1066.         The first character, in this case, the '9' is sacrosanct
  1067. as well as the 'YES' and the 'NO'. The rest of the prompt line
  1068. can be anything. The three character strings appearing after the
  1069. '9' separated by ',' can be anything you like to be displayed
  1070. centered on the three lines. The individual strings can be any
  1071. length, but total length of the line can not exceed 80 characters
  1072. and must start at the left edge of the screen. And last but not
  1073. least, the last character, here a "1" is the default if neither
  1074. of the selections is selected: a "1" indicates a YES, a "0"
  1075. indicates a NO.
  1076.  
  1077.  
  1078. Be Mouse Ready:
  1079.  
  1080.         Certain screen areas are "hot," namely the edges: top,
  1081. bottom, left, and right. pushing the mouse to an edge causes
  1082. MSHOW to look for a system menu screen named "TSIDE0", "BSIDE0",
  1083. "LSIDE0", "RSIDE0", representing top, bottom, left and right
  1084. edges respectively.  If one of these screens exist, the menu is
  1085. presented as discussed previously. Usually such a screen is
  1086. constructed of two segments: the menu and its context sensitive
  1087. help. To work properly, the menu must be positioned such that
  1088. MSHOW finds it first before finding the "help" segment. Remember,
  1089. MSHOW searches a screen left to right, top to bottom, to find a
  1090. segment to display. With this scheme it is not possible to place
  1091. a menu across the bottom of the screen with the "Help" segment
  1092. above it. The menu must be found first.
  1093.  
  1094.  
  1095. _____________________________________
  1096. VI. Create a Presentation with MDEMO
  1097.  
  1098.         Upon typing MDEMO at the DOS prompt and RETURN, the
  1099. screen goes blank and a menu appears across the bottom of the
  1100. screen.  This is screen # 1 of an as yet to be named file. It
  1101. happens to be a blank screen because you have not yet done
  1102. anything to improve its looks. However, there are things you can
  1103. do.  You can "Edit" it by selecting "Edit." You can create a box
  1104. and "Place" it anywhere on the screen. When you're finished doing
  1105. either of the above, press <Esc> and you will be asked whether
  1106. you wish to save the screen, and if so, name the file that will
  1107. become the presentation you are working on.  From that point on
  1108. you can perform a number of other operations upon that screen:
  1109. like choosing the "More" menu selection to see the other half of
  1110. the menu and then duplicating the screen or inserting a blank
  1111. screen, to name two.
  1112.  
  1113.         Or, upon startup, you could select "Files" and "Fetch" a
  1114. file that you previously worked on.  Or, if you are already
  1115. working on a file, choose "Files" again to suspend operations in
  1116. the work-in-process in order to look at another file with the
  1117. possible goal of inserting one or more screens from it into the
  1118. work-in-process.  Or you could look at previously "captured"
  1119. screens and insert them where desired. Or you can <PgDn> and
  1120. <PgUp> through an ASCII text file and import any sequence of 25
  1121. line chunks.
  1122.  
  1123.         Before we go on; we assume that you have digested the
  1124. "Help" file, "MDEMO.HLP". You saw them when you ran "DEMO.BAT."
  1125. Or if you have dabbled with creating a presentation or two and
  1126. have pressed F1, you got to the same file. It's important that
  1127. you spend some time viewing this presentation before going any
  1128. further in this manual. There's little sense duplicating some of
  1129. the same information here when viewing it as a presentation is so
  1130. much more satisfying.
  1131.  
  1132.         Go on: fetch a presentation, move through the screens
  1133. with a mouse or arrow keys and then "Save" it. Now you can save
  1134. some of the screens to a new file and then work on them
  1135. separately. Or you can save a screen to disk and "Fetch" it later
  1136. into another file or the same file but in a different place in
  1137. the sequence of screens.
  1138.  
  1139.         When working on a file, MDEMO handles screens just like a
  1140. word processor handles pages, except shuffling screens is a
  1141. little easier than shuffling pages. Changing the order of screens
  1142. can only be done by swapping adjacent screens. You can walk a
  1143. screen to a new location, but if the number of screens to bypass
  1144. is great, you might better "Save" the screen and then "Fetch" it
  1145. at the desired location.  Don't forget to go back and delete the
  1146. screen at its original location.
  1147.  
  1148.         For ease in handling, anticipate the presentation you
  1149. wish to create and try to break it down into a number of modules:
  1150. something along the lines of how you might define a number of
  1151. menu selections.  Work on these individually and when you are
  1152. finished with the pieces, combine them for the final result.
  1153.  
  1154.  
  1155. MDEMO Features:
  1156.  
  1157.         MDEMO has a number of features that make it easy for you
  1158. to create stunning screens with a minimum of effort.  Not only
  1159. can you edit anywhere on the screen, "Window" gives you the
  1160. capability to outline portion of the screen and, in effect,
  1161. "capture" that portion for editing. Turn on the "word-wrap"
  1162. feature by pressing <Insert>.  You can "Recolor" that portion
  1163. with the F3 and F4 function keys, you can make a "Copy" of it, or
  1164. "Erase" it or "Move" it and "Place" it somewhere else on that
  1165. screen or another. And you can resize the window by moving the
  1166. lower right corner using the <Ctrl> up arrow, down arrow, PgUp,
  1167. and PgDn keys.
  1168.  
  1169.         Remember to always "Place" a box you have created or a
  1170. portion of a screen that you have copied or moved before pressing
  1171. <Escape> to return to the main menu. In the event that you press
  1172. <Esc> without first "placing," in answer to the question, "Save
  1173. Screen?", answer "No." and try again.  When you want to "place" a
  1174. segment on another screen, as long as the segment has not been
  1175. "erased" in memory, it can still be "placed."
  1176.  
  1177.  
  1178. Using a Mouse:
  1179.  
  1180.         MDEMO is mouse aware; ie., if the mouse is NOT positioned
  1181. in the upper left corner of the screen.  If the mouse is anywhere
  1182. else, it is active. Pass it over a menu selection and watch that
  1183. selection become highlighted.
  1184.  
  1185.         Using a mouse really speeds things up. If you don't have
  1186. one, seriously think of getting one.  Whereas some programs let
  1187. you move a mouse anywhere on the screen with no apparent effect
  1188. other than seeing the mouse cursor move, MakeDemo immediately
  1189. shows you "hot" areas of the screen: you'll see the background
  1190. and foreground color change when the mouse passes over it. If you
  1191. see what looks like a menu, simply move the mouse to a what looks
  1192. like a selection and see if its colors change.  If it's a
  1193. selection you wish to make, merely click the left mouse button.
  1194.  
  1195.         Still, for those without a mouse, when a menu appears on
  1196. the screen, one of the selections is already highlighted. You
  1197. can use the arrow keys to maneuver through the various choices
  1198. and pressing <Enter> while highlighting a particular one,
  1199. selects that one.
  1200.  
  1201.         Backing out takes a few more words to explain.  Whether
  1202. using a mouse or not, pressing <Esc> any time causes one to step
  1203. back up through the menu tree and eventually out to DOS with
  1204. possibly some questions to answer (MDEMO only) before allowing
  1205. further retreat.  But the mouse works a little differently
  1206. whether you are using MakeDemo or viewing a presentation outside
  1207. of MakeDemo.  If within MakeDemo, moving the mouse off a
  1208. possible selection and clicking the left button does the same
  1209. thing as pressing the <Escape> key. If viewing a presentation,
  1210. such action is ignored. Instead, you must move the mouse right
  1211. to display the "mouse bar" on the right edge and move it to the
  1212. "Quit" row and then click the left button.
  1213.  
  1214.         You might ask, "Should I use the mouse in preference to
  1215. the arrow keys?"  Our experience indicates that using both can
  1216. really speed things up.  The trick we use here at WindhamWoods
  1217. Publishing in making presentations is to primarily use the
  1218. mouse with the right hand to block segments of the screen for
  1219. moving and copying etc., and with the left hand, be ready to
  1220. press the appropriate first letter of the command or menu
  1221. selection for what we want to do with it. Even if you have
  1222. chosen to hide the menu bars on the bottom lines of the screen,
  1223. the selections still work. It saves steps later after you know
  1224. the more commonly used keys.
  1225.  
  1226.         You might want to temporarily disable the mouse when
  1227. you're moving or copying a segment around on the screen.
  1228. Remember to move the mouse to the screen's upper left corner.
  1229. When using the mouse to move "pick & place" segments around on
  1230. the screen, note that the segment tries to adjust itself so that
  1231. its lower right corner aligns with the mouse. This is not always
  1232. possible, especially when the segment is wide, and then the mouse
  1233. appears to have no effect. Just be aware.
  1234.  
  1235.         Clicking the left button once anchors the box temporarily
  1236. and brings up a second menu on the next to bottom line of the
  1237. screen. It is not necessary to see this menu to use it. Once you
  1238. know what selections are available you can select one directly by
  1239. pressing the appropriate capitalized letter for that selection.
  1240.  
  1241.  
  1242. Large Fonts:
  1243.  
  1244.         After selecting "Edit" you can then select "Fonts" by
  1245. pressing the function key, F10.  You will be presented with a
  1246. window displaying a word in one of the many fonts that are
  1247. available. Press <Return> to select the displayed font; any other
  1248. key will display the same word in another font. Continually
  1249. pressing a key other than <Return> will cycle through all the
  1250. available fonts.
  1251.  
  1252.         Using any of the large fonts is somewhat crude.  For
  1253. simple tasks like making titles, etc., they work fine. However,
  1254. don't expect to be able to word wrap.
  1255.  
  1256.         In using large fonts, it's best to get what you want on
  1257. each line and then use "Pick & Place" to move a screen segment
  1258. into final position, etc.  When you are finished using a large
  1259. font, one press of <Escape> first gets you back to normal font;
  1260. a second press gets you out of the "Edit" mode.
  1261.  
  1262.  
  1263. PLEASE NOTE: The fonts are contained in FONTS.WWP, an ASCII file
  1264. that you can add to or modify to your own wishes. The system is
  1265. pretty easy to figure out. Just be consistent.
  1266.  
  1267.  
  1268. Appearance Modes:
  1269.  
  1270.         There are three aspects to presenting a screen. First is
  1271. the method such as simulated blinds or sprinkling.  There are
  1272. over 20 choices: some for the entire screen, some for overlays
  1273. where only a portion of the screen is updated. A second aspect is
  1274. "sound." Some of the methods have a built in sound effect unique
  1275. to that method. In general, it's best to forgo the sound effects
  1276. except where you desire to emphasize a particularly strong point.
  1277. They wear pretty thin after hearing them a few times. And lastly,
  1278. there is the duration with 5 choices available.
  1279.  
  1280.         To define the appearance options, they can be accessed by
  1281. selecting "More" at the main menu and then selecting
  1282. "Appearance."
  1283.  
  1284.  
  1285. Overlays, the Key to Presentation Effects.
  1286.  
  1287.         A screen of 25 rows by 80 columns has room for 2000
  1288. characters. However, a screen character also has color
  1289. information. For each character there exists a color attribute
  1290. "character" defining the background and foreground color.
  1291. Therefore, a screen commandeers 4000 bytes, of character space in
  1292. memory or on disk.
  1293.  
  1294.         There are 8 background (all low intensity) colors and 16
  1295. foreground (the same 8 low intensity and 8 new high intensity)
  1296. colors.
  1297.  
  1298.         MakeDemo makes the assumption that no presentation
  1299. segment will use a low intensity foreground color on a black
  1300. background. It really looks pretty drab.
  1301.  
  1302.         But that is not strictly true. As long as a segment box
  1303. has a top and left edge of a high intensity foreground on any
  1304. background, MSHOW will recognize the rectangle so defined as a
  1305. segment and deal with it accordingly. Just use spaces for the top
  1306. row and left column.  The foreground color is only used for
  1307. characters.
  1308.  
  1309.         MakeDemo finds the height and width of a segment, as we
  1310. discussed before, by first finding the upper left corner of a
  1311. segment, remembering the color attribute of that spot, and
  1312. "looking" along the top row from left to right for a change in
  1313. the color attribute or the screen edge, whichever comes first. In
  1314. like manner, MakeDemo "looks" down the left edge to find the
  1315. bottom row.
  1316.  
  1317.         Consequently, you can place segments, as defined by their
  1318. upper and left edges, anywhere on the screen and MSHOW will be
  1319. able to find and display them. Stack them or place them side by
  1320. side.
  1321.  
  1322.         MSHOW looks for the upper left corner of segments,
  1323. first from left to right, then top to bottom.
  1324.  
  1325.         Put a "bright" top and left edge on a screen and the
  1326. screen becomes one segment. Then use one of the display methods
  1327. that are designed for use with segments, such as scrolling and
  1328. sliding.
  1329.  
  1330.  
  1331. Screen Test:
  1332.  
  1333.         Screen Test is very powerful for looking at a screen as
  1334. MSHOW sees it for presentation, especially if you select one of
  1335. the overlay or "segment" modes for displaying that screen. It is
  1336. only available from the "Pick & Place" menu. It is a momentary
  1337. display of the screen showing 25 rows of 80 diamond in place of each
  1338. character, spaces or otherwise. The foreground/background color
  1339. of each character is the important thing to look at.  Remember,
  1340. screen segments for overlays and menu selections rely on being
  1341. surrounded by different colors and/or dull colored diamonds on a
  1342. black background. Use screen test to check the screen. Almost
  1343. always, when a screen doesn't appear as designed, it's because
  1344. MSHOW doesn't ghet the right clue as to where a segment's
  1345. corners are located or where a menu selection highlight ends.
  1346.  
  1347.         Because screens are compressed before saving, "Screen
  1348. Test" is indespensible in minimizing the size of the screen as
  1349. saved in the file. In brief, as the screen is compressed, first
  1350. and foremost all the color attributes for each character is put
  1351. through a form of run length encoding. Basically, each time the
  1352. color attribute changes the length of a screen record increases
  1353. by three bytes. After working on a screen using "Pick & Place,"
  1354. moving a few things around, erasing something, etc., the
  1355. screen might be what you want, but the color attibute for spaces
  1356. can be anything but one color, preferably dull green on a black
  1357. background.  From "Pick & Place" it's an easy step to do a
  1358. "Screen Test", move the corners to the area in question and
  1359. "Blank" that section or recolor it to your desires, then recheck
  1360. again with "Screen Test."
  1361.  
  1362.  
  1363. Viewing a Work-in-Process:
  1364.  
  1365.         MDEMO gives you the ability to shell out to DOS. Once at
  1366. DOS again you run any program including MSHOW to view your
  1367. work-in-process. MSHOW.EXE is the file that presents your
  1368. creation(s). This one file can be used in stand alone fashion to
  1369. present any number of your creations, as in
  1370.  
  1371.                 MSHOW MYDEMO    or
  1372.                 MSHOW THISDEMO  or
  1373.                 MSHOW THATDEMO
  1374.  
  1375. for viewing.  When finished, remember to type EXIT and <Return>
  1376. to get back to your MDEMO session.
  1377.  
  1378.         Incidently, MSHOW has the capability for shelling out to
  1379. DOS should you choose to make it available to your viewers.
  1380.  
  1381.         Or, as discussed in the next section, you can combine
  1382. YOURDEMO with MSHOW.EXE using WWP_MAKE.EXE to create a single
  1383. executable file.  For uploading and downloading over BBSs this
  1384. makes the most sense.
  1385.  
  1386. __________________________________________
  1387. VII. Making Single .EXE file Presentations
  1388.  
  1389.         Any MakeDemo file can be made into its own .EXE file. But
  1390. there are a few restrictions. First of all, the number of screens
  1391. in a file can not exceed 2000. And second, if you want to include
  1392. your own "Help," it must be part of the same file. I suppose that
  1393. goes without saying.
  1394.  
  1395.         MSHOW.EXE serves two purposes.  It can be used as is to
  1396. present an MDEMO created file.  And it also is the basis for
  1397. making those smaller single .EXE file presentations.  The utility
  1398. WWP_MAKE.EXE does the work for you, by combining the necessary
  1399. elements into one file.
  1400.  
  1401.         The command line must include two arguments and,
  1402. optionally, a third.  MYDEMO.EXE, if it already exists, will be
  1403. replaced with the new.  The file names for the two arguments are
  1404. arbitrary; use any names you like. If WWP_MAKE can not find the
  1405. file specified by the second argument, it terminates and returns
  1406. to DOS.
  1407.  
  1408. C:\MDEMO> WWP_MAKE MYDEMO.EXE PRESENT.MD4 1234567,ABCD
  1409.                    ---------- |_ _ _ _ _ |------------
  1410.                         |     |Presenting|  Branding
  1411.                         |     |   File   |    Info
  1412.                         |     |_ _ _ _ _ |      |
  1413.                         |          |            |
  1414.     +- - - - - -+       |   _ _ _ _|            |
  1415.     |           |       |  |                    |
  1416.     | MSHOW.EXE |       |  |                    |
  1417.     |           |       |  |                    |
  1418.     +- - - - - -+       |  |                    |
  1419.           |      +- - - - - - - -+              |
  1420.           |      |  MYDEMO.EXE   |              |
  1421.           |_ _ _ |    Single     | _ _ _ _ _ _ _|
  1422.                  |     File      |
  1423.                  +- - - - - - - -+
  1424.  
  1425.  
  1426.         WWP_MAKE combines MSHOW.EXE, your presentation file, and
  1427. its associated index file into one .EXE file: everything in one
  1428. file. However, the index file must exist first for WWP_MAKE to
  1429. complete its task. Remember, MSHOW automatically creates the
  1430. index file if it doesn't exist when viewing a presentation with
  1431. MSHOW.EXE. The point is: be sure to run a presentation through
  1432. MSHOW before making the .EXE executible.
  1433.  
  1434.         WWP_MAKE also includes a "work around" for a potential
  1435. problem with machines using DOS versions prior to 3.0.  Let me
  1436. explain.  With the advent of 3.0, a single file executable can
  1437. determine its own file name, while executing, and open itself a
  1438. second time to access the appended presentation. To enable your
  1439. presentations to function on machines using prior versions of
  1440. DOS, MSHOW looks for the file name hard-coded into the EXE
  1441. composite file. If you were to "debug" such a file, you would
  1442. discover its name imbedded in the code.  A subtle consequence of
  1443. this "trick" is that your final creation will only work with DOS
  1444. versions prior to 3.0 PROVIDED that you DO NOT CHANGE the name of
  1445. the executable file after you have created it. It will not work
  1446. if RENamed.
  1447.  
  1448.  
  1449. Branding
  1450.  
  1451.         In addition, you have the option of branding your final
  1452. creation so that, should your viewer not use the correct
  1453. validation code which you assign, any 'shareware' screens in your
  1454. presentation will be activated. Your creation will not be
  1455. crippled in any way. Any screen with the name "NAG" will be shown
  1456. just like any other. You can put anything on it that you like. In
  1457. fact you can include more than one NAG screen placed
  1458. strategically in your file, as long as each screen has the name
  1459. "NAG".
  1460.  
  1461.         Note the third argument in the syntax for using
  1462. WWP_MAKE.EXE.  Here you should replace the number '1234567' with
  1463. some other number known only to you. That number seeds a quasi
  1464. random number generator. You can use any seven digit number above
  1465. 1000000, or one million;
  1466.  
  1467.         followed by a comma, with no spaces;
  1468.  
  1469.         followed by a four digit serial number greater than 1000
  1470.         to replace, ABCD, which you can choose to your liking.
  1471.  
  1472.         To find the corresponding password for a unique serial
  1473.         number, KEY.EXE has been included.
  1474.  
  1475.         The syntax for using KEY.EXE is
  1476.  
  1477.                     KEY 1234567
  1478.  
  1479.         where 1234567 is the same seed number discussed above.
  1480.  
  1481.         KEY will then ask for the serial number you imbedded in
  1482. your executable file and will display its corresponding password.
  1483. For example, if (as we did in DEMO.BAT) you use the seed number,
  1484. 1234567, and assign a serial number of 1000, then using the
  1485. utility, KEY.EXE, you would calculate the validation code to be
  1486. '2236'.
  1487.  
  1488.  
  1489. ________________________________________________
  1490. VIII.  MLITE, The MakeDemo Stripped Down Runtime
  1491.  
  1492.         Registered users have requested a MakeDemo runtime that
  1493. takes up as little disk space as possible while still providing
  1494. the minimum in functionality. MLITE.EXE weighs in at a little
  1495. over
  1496. 13 k Bytes. It's sole function is to show a series of screens
  1497. (i.e. full screens: no overlays.) There is no provision for Help
  1498. at the touch of the F1 key. There is no support for either a
  1499. mouse or menus. And branding is not supported as well.
  1500.  
  1501.         There are two ways to exit MLITE. The first is the <Esc>
  1502. key which in addition sets the DOS ERRORLEVEL to a 1. The other
  1503. is the <Return> or <Enter> key which leaves the DOS ERRORLEVEL
  1504. set at 0.
  1505.  
  1506.         A presentation can be appended to the end of MLITE, just
  1507. like with MSHOW, except its length can not exceed 35 k Bytes.
  1508. That's about 45 screens, give or take.
  1509.  
  1510.         Seven and only seven key strokes are recognized:
  1511.  
  1512.     PgUp or
  1513.       Up Arrow Key      Presents previous screen
  1514.  
  1515.     PgDn or
  1516.       Down Arrow Key    Presents next screen
  1517.  
  1518.     F5                  Toggles between monochrome and color
  1519.  
  1520.     Return
  1521.       or Enter          Presents next screen, if it exists, or
  1522.                           exits with DOS ERRORLEVEL = 0
  1523.  
  1524.     Esc                 Exits with DOS ERRORLEVEL = 1
  1525.  
  1526.  
  1527.         MLITE is useful for making a front end for other software
  1528. where a few expository screens would help get the novice users
  1529. off to a good start. For example, you might want to take a look
  1530. at START.BAT. We've used it as a way to start MDEMO with a few
  1531. start-up screens that experienced users can later avoid by
  1532. calling MDEMO directly from the command line. To those of us in
  1533. the shareware business, especially ASP members, now we can
  1534. present a more elaborate shareware message to first time users
  1535. without mucking up the programs themselves with allocated, but
  1536. never used again, memory.  Disk vendors can now incorporate a
  1537. small front end on all the disks they distribute.
  1538.  
  1539.         You'll note that START.BAT uses MLITE.EXE with a command
  1540. line argument: namely the name of the file to present,
  1541. MESSAGE.1ST. I could have used WWP_MAKE to combine the two into
  1542. an .EXE file, but I left them separate to minimize the size of
  1543. the archive.
  1544.  
  1545. IMPORTANT NOTE:
  1546.  
  1547.     WWP_MAKE expects to append the presentation file to a copy of
  1548.     MSHOW.EXE to produce the final .EXE file. Therefore, if you
  1549.     wish to fool WWP_MAKE into using MLITE.EXE instead, you must
  1550.     REName it to something like MSHOW1.EXE, COPY MLITE.EXE to
  1551.     MSHOW.EXE, run WWP_MAKE, and then REName MSHOW1.EXE to
  1552.     MSHOW.EXE.
  1553.  
  1554. To automate this process, you might consider writing two batch
  1555. files and place them in the directory with all the MakeDemo
  1556. files. Here are the two listings:
  1557.  
  1558.             REM GO_MLITE.BAT
  1559.             COPY MSHOW.EXE MSHOW1.EXE
  1560.             COPY MLITE.EXE MSHOW.EXE
  1561.  
  1562. and
  1563.  
  1564.             REM GO_MSHOW.BAT
  1565.             COPY MSHOW1.EXE MSHOW.EXE
  1566.  
  1567. With the MakeDemo directory listed in your "PATH" statement of
  1568. your AUTOEXEC.BAT file, you can make the switch while working in
  1569. any other directory.
  1570.  
  1571.  
  1572. _________________________
  1573. IX. MDEMO Quick Reference
  1574.  
  1575. Function Keys
  1576.         F1 - Help               F2 - MakeDemo Logo
  1577.         F3 - Background Color   F4 - Foreground Color
  1578.         F5 - Color/ Monochrome  F6 - Print (normally off)
  1579.         F7 - (not used)         F8 - Grab Color
  1580.         F9 - Menu (normally on) F10 - Fonts ( Edit only)
  1581.  
  1582. Pick & Place / Box / Recolor
  1583.         Move Box
  1584.             Horizontal          Left or Right Arrow Keys
  1585.             Vertical            Up or Down Arrow Keys
  1586.             Mouse               Mouse controls lower right
  1587.                                     corner. Box follows.
  1588.  
  1589.         Resize Box
  1590.             Horz.      <Ctrl> + Left or Right Arrow Keys
  1591.             Vert.      <Ctrl> + <PgUp> or <PgDn> Keys
  1592.             Mouse               HOLD DOWN Right Button.
  1593.                                     Anchors Upper Left Corner.
  1594.                                     Drag Mouse to Change Size.
  1595.                                     Release Right Button.
  1596.  
  1597.         Copy    Save segment to memory, leaving screen intact.
  1598.         Move    Same as "Copy" plus erase blocked screen area.
  1599.         Erase   Erase saved screen segment kept in memory.
  1600.         Blank   Erase blocked screen segment.
  1601.         Place   Replace screen segment with that now visible.
  1602.  
  1603. ___________________
  1604. X. Customer Support
  1605.  
  1606.         WindhamWoods Publishing is a small software company owned
  1607. and operated by Warren Munroe.  At WindhamWoods Publishing we
  1608. believe that the PRIMARY purpose of business is service, not
  1609. profit.  This concept is fundamental to our approach to product
  1610. development, production and marketing.  WindhamWoods Publishing
  1611. has been producing top quality computer software at reasonable
  1612. prices, continuously, since 1989.
  1613.  
  1614.         Please feel free to contact me (Warren Munroe) at any
  1615. time if you have any questions, comments or suggestions.  I can
  1616. be reached by mail, phone, or Compuserve:
  1617.  
  1618.    Warren Munroe              Phone:                 603.893.2667
  1619.    WindhamWoods Publishing    Orders & Tech Support  603.893.2667
  1620.    P. O. Box 314              CompuServe             72260,1700
  1621.    Windham, NH  03087
  1622.    U.S.A.
  1623.  
  1624.